Direito SP
Mestrado e Doutorado
Aula 2 · Labtech 2026Extração, tabulação
e anonimização
Extrair dados de um documento é fazer perguntas a ele. O pesquisador escreve as perguntas; a máquina responde e mostra onde leu cada resposta.
Prof. Anderson Fraiha Machado Disciplina eletiva · 2026
Direito SP
Mestrado e Doutorado
RetomadaNa Aula 1 vocês coletaram os documentos. Hoje vamos transformá-los em dados
| Coluna do corpus.csv | Diz |
|---|
| id, tribunal, classe | de que processo se trata |
| data, órgão julgador | quando e onde |
| inteiro_teor_path | onde está o texto |
Que coluna falta nesta planilha para responder à sua pergunta de pesquisa?
Todas as que dependem de ler: o resultado, o fundamento, o valor.
10 min. Projetar o corpus.csv e o registro.json de um aluno.
Direito SP
Mestrado e Doutorado
01
Tabulação manual
Triagem, leitura e variáveis, dinâmica em grupos.
Direito SP
Mestrado e Doutorado
0 · Tabulação manual · dinâmicaMesmas seis decisões, a mesma planilha, todos os grupos
| Variável | O que anotar |
|---|
| Desconsideração deferida? | sim / não / parcial |
| Fundamento | art. 50 do CC / art. 28 do CDC / outro |
| Modalidade | direta / inversa |
| Valor em discussão | em reais, se houver |
1
Triagem
serve para a pesquisa?
2
Leitura
busca as informações
14 minutos. Cada integrante lê duas decisões; o grupo consolida.
4 min de montagem. 2 das 6 decisões são inelegíveis — a turma NÃO é avisada. Decisões curtas, até 3 páginas, das íntegras do STJ (CC-BY).
Direito SP
Mestrado e Doutorado
0 · Tabulação manual · reporteAs planilhas dos grupos não batem, e ninguém errou
Nas inelegíveis
uns grupos tabularam, outros descartaram
No "parcial"
ninguém definiu o que conta como parcial
No fundamento
a decisão cita os dois artigos: qual prevalece?
Sem domínio definido e regra de decisão, cada pesquisador codifica de um jeito.
12 min de reporte. Planilhas lado a lado no telão; ficam visíveis até o fechamento.
Direito SP
Mestrado e Doutorado
0 · Tabulação manual · o instrumentoO livro de códigos é a primeira versão do guia de extração
| Pergunta | Domínio | Regra de decisão | Exemplo |
|---|
| A desconsideração foi deferida? | sim · não · parcial · não identificado | parcial = deferida só para parte dos sócios ou dos bens | “defiro em relação ao sócio A” |
| Qual o fundamento? | art. 50 CC · art. 28 CDC · outro | se citar os dois, vale o que a decisão aplica | “com base no art. 50” |
Não se tabula tudo: cada variável existe porque serve à tese da pesquisa.
Conceitos: variável, domínio, unidade de análise, critério de elegibilidade.
Direito SP
Mestrado e Doutorado
0 · Tabulação manual · escalaQuanto tempo levaria para tabular o corpus inteiro
14 min
um grupo de quatro para 6 decisões curtas
≈9 min
de trabalho por decisão
50 horas
para as 340 do seu corpus, sem a segunda leitura
Pergunta natural: e se a máquina procurasse palavras?
Direito SP
Mestrado e Doutorado
1 · Limites das palavras-chaveA palavra-chave encontra o tema, mas não o sentido da decisão
- Negação“não é caso de desconsideração da personalidade jurídica”
- O verbo inverte o resultado“indefiro o pedido de desconsideração”
- Palavra certa, sentido errado“a desconsideração, embora pleiteada, não se justifica”
- Adjetivação“evidente abuso” × “ausente qualquer abuso”
10 min, ao vivo nas mesmas 6 decisões: a regra ingênua marca como positivas decisões que negam o pedido.
Direito SP
Mestrado e Doutorado
1 · Limites das palavras-chaveExtrair é passar do texto corrido para a tabela
Não estruturado
- A sentença, o acórdão, a petição
- Texto corrido, cada um de um jeito
- Lido por pessoas
Estruturado
- A planilha, o corpus_extraido.csv
- Uma linha por caso, uma coluna por variável
- Lido por máquinas e por análises
5 min.
Direito SP
Mestrado e Doutorado
2 · Reconhecimento de entidadesNER: a máquina marca nomes, datas e leis no texto
Pessoa
partes, advogados, magistrados
Organização
empresas, órgãos
Legislação
artigos e leis citados
Jurisprudência
decisões citadas
Categorias do LeNER-Br, a leitura básica: documentos jurídicos brasileiros anotados para treinar esse tipo de modelo.
5 min de conceito + 6 min de demonstração num acórdão real.
Direito SP
Mestrado e Doutorado
2 · Reconhecimento de entidadesO que o NER resolve e o que ele não resolve
Ajuda
- Partes, datas, valores e leis citadas
- É a primeira passada da anonimização (Bloco 5)
Não chega
- "A desconsideração foi deferida?" não é uma entidade
- É uma interpretação
4 min. Pergunta que leva ao Bloco 3: e se a máquina lesse como um pesquisador?
Direito SP
Mestrado e Doutorado
3 · Mineração com LLMsDo livro de códigos ao guia de extração
5
Na dúvida
não identificado
Escrever um guia de extração é escrever um prompt estruturado. A Aula 5 usa a mesma técnica no revisor.
Demonstração: o guia + uma das 6 decisões num assistente de IA, conferido com o gabarito dos grupos.
5 min + 7 min de demonstração.
Direito SP
Mestrado e Doutorado
3 · Mineração com LLMs · o que apareceO assistente responde, mas não no formato que a pesquisa precisa
Cada vez num formato
texto corrido, que não cabe na planilha
Afirma sem base
afirma o que não está no documento
Sem fonte
não diz onde leu
Como obrigar a resposta a caber na planilha, mostrar de onde veio e dizer quanto confia?
3 min. Fica no ar durante o intervalo.
Direito SP
Mestrado e Doutorado
Intervalo
Na volta: esquema, trecho de origem e grau de segurança.
Direito SP
Mestrado e Doutorado
4 · Extração com esquema · fundamentosUm LLM prevê a continuação mais provável
- Não consulta fontea menos que você entregue o texto: por isso o documento vai junto com a pergunta.
- Soa igual quando acerta e quando inventapor isso o trecho de origem é o controle.
Modelos gerais × jurídicos
O LEGAL-BERT (leitura complementar) é o exemplo clássico de modelo treinado em texto jurídico.
7 min.
Direito SP
Mestrado e Doutorado
4 · Extração com esquemaO livro de códigos em formato que a máquina é obrigada a respeitar
{
"deferida": ["sim","não","parcial",
"não identificado"],
"fundamento": ["art. 50 CC","art. 28 CDC",
"outro","não identificado"],
"modalidade": ["direta","inversa",
"não identificado"],
"valor": "número (R$)",
"trecho_origem": "citação literal
que sustenta cada resposta"
}Saída estruturada garante o formato, não o acerto.
6 min.
Direito SP
Mestrado e Doutorado
4 · Extração com esquema · o JevJev: decisões dentro do esquema, com grau de confiança
| O fabricante diz | Como ler |
|---|
| "Não alucina" | não consegue responder fora do esquema, pode marcar a alternativa errada com toda a formalidade |
| "É calibrado" | confiança alta deveria significar acerto alto: é alegação, e a turma vai testar |
| Probabilidade e confiança em cada resposta | útil para decidir o que vai para revisão humana |
TypeSafe AI, lançado em 15/09/2026, em acesso antecipado. Plano B: GPT ou Claude com saída estruturada.
7 min, com demonstração nas 6 decisões do Bloco 0.
Direito SP
Mestrado e Doutorado
4 · Extração com esquema · grau de segurançaO grau de segurança precisa ser medido, não declarado
1
Codificar à mão
o gabarito do Bloco 0
2
Comparar
variável por variável
3
Conferir a confiança
ela acompanha o acerto?
4
Regra de revisão
sem trecho ou abaixo do limiar → humano
5 min.
Direito SP
Mestrado e Doutorado
5 · Anonimização · por que agoraOs documentos vão para um serviço externo e o dataset pode ser publicado: por isso anonimizar agora
| Conceito | Onde está na LGPD |
|---|
| Dado pessoal · dado pessoal sensível | art. 5º, I e II |
| Dado anonimizado · anonimização | art. 5º, III e XI |
| Dado anonimizado deixa de ser pessoal, salvo se reversível | art. 12 |
| Pseudonimização: só volta a identificar com informação guardada à parte | art. 13, § 4º |
3 min + 6 min. Conferir a redação dos artigos antes do slide.
Direito SP
Mestrado e Doutorado
5 · Anonimização · as técnicasQuatro técnicas; o que muda é se dá para reverter
| Técnica | Exemplo | Reversível? |
|---|
| Mascaramento | João S* | em parte |
| Supressão | o nome some do texto | não |
| Pseudonimização | João Silva → PARTE_017, tabela guardada à parte | sim, com a tabela |
| Anonimização | nenhum caminho de volta à pessoa | não |
4 min.
Direito SP
Mestrado e Doutorado
5 · Anonimização · revisão humanaO NER faz a primeira passada. O que ele deixa passar
- O nome na razão social: “Fulano Silva Comércio Ltda.”
- O apelido e o parentesco que denunciam.
- O endereço que identifica.
O programa exige uma versão tratada para revisão humana, sem presumir que o automatizado basta.
Decisão é pública (Res. CNJ 121/2010). Republicá-la num dataset, com nome, para outra finalidade, é outra coisa.
5 min de demonstração + 2 min da tensão. Leitura: Csányi et al.
Direito SP
Mestrado e Doutorado
6 · ArtefatoO Extrator Jurídico aplica o guia de extração a cada documento
Extrator Jurídico
As perguntas do pesquisador, respondidas dentro do esquema, cada uma com o trecho que a sustenta e o grau de confiança.
- Entracorpus.csv anonimizado + o guia de extração.
- Saicorpus_extraido.csv: variável, trecho de origem e confiança.
- E aindaa versão anonimizada e o registro.json.
3 min + 12 min de demonstração: gabarito × grupos × máquina, lado a lado. Os humanos também discordavam entre si.
Direito SP
Mestrado e Doutorado
6 · Artefato · onde ele falhaOnde a ferramenta erra, de propósito
Extrai o inelegível
a triagem precisa estar no guia
Erra no "parcial"
domínio mal definido vira erro em série
Trecho que não sustenta
existe, mas não diz o que a resposta diz
Anonimização vaza
o nome embutido passa
5 min.
Direito SP
Mestrado e Doutorado
7 · OficinaO guia de extração da sua pesquisa
10'
Guia
3 variáveis, com domínio e regra
10'
Codificar à mão
2 documentos e comparar
2'
Registro
salvar o registro.json
No laboratório: 3 a 5 variáveis, 20 documentos, 5 codificados à mão.
27 min. Cobrar: domínio com "não identificado"? triagem no guia? trecho conferido?
Direito SP
Mestrado e Doutorado
Laboratório 2 de 5Construa o guia, aplique com o Extrator e meça onde vocês discordam
- Descrição da tarefa realizada.
- Ferramenta utilizada.
- Resultado: o corpus_extraido.csv e o guia.
- Verificação: a comparação dos 5 documentos codificados à mão.
- Pelo menos uma limitação ou risco identificado.
O registro.json já traz esses itens e é recomendado como anexo.
Direito SP
Mestrado e Doutorado
FechamentoTrezentos documentos extraídos com o mesmo guia,
cada resposta com o trecho de origem e a confiança medida.
Esquema fixo, confiança medida, anonimização antes de sair da máquina. Na Aula 3, esses dados viram um painel.
anderson.machado@fgv.br Aula 3: jurimetria
Retomar o guia de extração da oficina: o que era planilha divergente no começo da aula virou esquema, trecho e grau de segurança.